home *** CD-ROM | disk | FTP | other *** search
/ GameStar 2004 April / Gamestar_61_2004-04_dvdb.iso / DVDStar / Editace / hltp.exe / {app} / Source Code / QuArK / source / DELPHI-README.txt < prev    next >
Text File  |  2004-01-05  |  4KB  |  84 lines
  1. This is the source code of QuArK. It should work with Delphi 2, 3, 4, 5.
  2.  
  3. *** INSTALLATION ***
  4.  
  5. Important ! Follow the steps below !
  6.  
  7. 1) Checkout all the "source" module with your CVS program (I guess you
  8.    already did if you are reading this).
  9.  
  10. 2) Run Delphi but DON'T OPEN THE QUARK.DPR PROJECT IMMEDIATELY
  11.  
  12. 3) Install the required components (found in the "components" subdirectory):
  13.  
  14.     For Delphi 4 and 5, you must install the package "vclar40"; doing so will
  15.     install the Delphi components I use in QuArK. See Delphi's Component menu,
  16.     Install Packages...
  17.  
  18.     For Delphi 2 and 3, directly install the components (Component, Install).
  19.     All the .pas files in the "components" subdirectory contain components,
  20.     expected "ShellObj.pas" and "BrowseForFolder.pas".
  21.  
  22.     Important : with Delphi 2 and 3, if the source code of any component is
  23.     modified, you must do Component, Rebuild library. Be careful about it as
  24.     WinCVS will probably not explicitely warn you that the component source code
  25.     was modified. With later versions of Delphi I guess (but I'm not sure) that
  26.     recompiling occurs automatically.
  27.  
  28.     The components in TB97 are by Jordan Russell; marsCaption is by Chen Ken.
  29.     These ones are not covered by the GNU General Public Licence. The other
  30.     components are by myself (Armin Rigo) and covered by the GNU GPL.
  31.  
  32. 4) Only then you can open the "QuArK.dpr" project. Be careful that the source on
  33.    CVS does not include (on purpose) a file "QuArK.cfg" which would give the
  34.    compiling options of the project, because this file contains absolute paths.
  35.    You have to open the Project, Options dialog box and configure a few things:
  36.  
  37.     First, in Conditional defines, add DEBUG. This will make QuArK compile as
  38.     beta version with a lot of internal tests. Note: after you added or removed
  39.     this setting, you must completely rebuild QuArK (Compile menu, Build) or you
  40.     will get compilation errors.
  41.  
  42.     Second, set output directories. I would recommend that all .dcu and .exe files
  43.     are written into a completely separated directory reserved for this purpose,
  44.     like c:\temp\delphiexe.
  45.  
  46.     Third, if necessary, set the directories where Delphi should look for files.
  47.     What you mainly need to add is the "components" subdirectory.
  48.  
  49. 5) Compile and enjoy!
  50.  
  51.  
  52. *** THE INFOBASE ***
  53.  
  54. Don't forget the link to the InfoBase:
  55.  
  56.   http://www.planetquake.com/quark/infobase/index.html
  57.  
  58. You are welcome to make changes to the CVS-stored InfoBase. After you did so,
  59. visit this URL (warning, this URL might change later):
  60.  
  61.   http://imaux.unil.ch:8000/infobase/
  62.  
  63. Doing so will update the InfoBase at PlanetQuake.
  64.  
  65.  
  66. *** RUNNING NOTES ***
  67.  
  68. QuArK expects to find a lot of things (the .qrk files, the quarkpy and plugins
  69. directories, etc.) where the quark.exe file is. With a recent version of Delphi
  70. you can configure it to write the compiled units (.dcu) into c:\temp\delphiexe
  71. and only the quark.exe into another directory. Another solution is to use an
  72. environment variable: if QUARKPATH is set, QuArK will use this path instead of
  73. the path where the .exe is stored. To set environment variables on Win95/98, edit
  74. your file "autoexec.bat" and add a line:
  75.  
  76.   SET QUARKPATH=c:\some\path
  77.  
  78. On WinNT, go to Control Panel, System. An alternate solution could be added if
  79. you think it might be useful, e.g. having QuArK recognize a run-time parameter
  80. like "--quark-path=...". Delphi lets you specify run-time parameters and they are
  81. saved when you leave Delphi.
  82.  
  83.  
  84. Armin Rigo